<>> Succubus Heart <<>
  >  Source Notes  <
(This document holds source information)

- Naming Conventions -

SuH / suh
	all Succubus Heart objects will prefix with this to ensure easy finding and reduce chances of overlapping with other mods.
ent/ and end/
	These are nodes I use in notepad++ and other text editors to create clamps for easy navigation

.E.    ; Effect
.S.    ; Script
.sex.  ; Sex Effect
.spell.; Succubus Spell
.pass. ; Succubus Passive
.T.    ; Spell Trigger
.SET.  ; Configurable Setting
.NPC.  ; Non-Playable Character
.PC.   ; Player Character
.PCS.  ; Player Character Stat
.dyna. ; Dynamic Script Element
.anim. ; Animation Event
.ing.  ; Ingredient
.com.  ; Common Use / General Use
.stat. ; Status State

r. ; Reference
v. ; Variable / Object
s. ; Script
f. ; Function

PC Mastery ; When the player is considered the Aggressor
PC Training ; When the player is considered Consentual
PC Submit ; When the player is considered the Victim
NPC Attacker ; When the NPC is considered the Aggressor
NPC Consent ; When the NPC is considered Consentual
NPC Victim ; When the NPC is considered the Victim

+ Quests +
	SuH_Main ; Handles MODupdate and primary animation triggers
		r. PlayerRef ; Ref. Player
		s. SuH_Main ; The Quest Script
			f. MODupdate ; Compares MODversion and updates the mod
			f. anim_NPC_Start ; Triggers when an NPC starts an act
			f. anim_NPC_Orgasm ; Triggers when an NPC orgasms
			f. anim_NPC_End ; Triggers when an NPC act ends
			f. anim_PC_Start ; Triggers when the PC starts an act
			f. anim_PC_Orgasm ; Triggers when the PC orgasms
			f. anim_PC_End ; Triggers when the PC act ends
		s. SuH_Main_Player ; On playerLoad run's update script
			s. SuH_Main ;ref
	SuH_MCM ; Creates and Handles the MCM
		r. PlayerRef ; Ref. Player
		s. SuH_MCM ; Quest Script
			f. OnConfigInit ; Runs initial function
				a. Pages ; Determines MCM Page # and Names
	SuH_Fun ; Handles Global Functions
		s. SuH_Fun ; Quest Script
			f. XPcalc ; Calculates XP gained
				(string aPreset, float aMOD, int XPearn, float lvlS, bool dReport)
				aPreset ; Effect Preset and Define (Used by default effects)
					PCmastery ; Mastery Act
					PCtraining ; Training Act
					PCsubmit ; Submit Act
					PCsperm ; Sperm Consume
					PCmilk ; Milk Consume
				aMOD ; Calculates an added percentage gain, will be overwritten by presets (Adds to inherited XPgain value)
				XPearn ; Sets XP earned, when using a preset this value adds to the default amount (set to 0 to use default)
				lvlS ; XPearn added per-character level, will be overwritten by presets (Set to 0 to disable)
				dReport ; Sends Notification for the player based on gain
					TRUE ; Send Report
					False ; Don't Send Report
			f. STATcalc ; Calculates Stats gained
				(Actor eChar,bool PCin, string aPreset,string Stat, bool drainC,float aMOD,float aEffect,bool dReport)
				eChar ; Character to effect
				PCin ; Is Player Involved?
					TRUE ; Player is involved
					FALSE ; Player is not involved
				aPreset
					PCmastery ; Mastery Act
					PCtraining ; Training Act
					PCsubmit ; Submit Act
					PCsperm ; Sperm Consume
					PCmilk ; Milk Consume
				Stat ; Stat Changed
					All ; Change Health, Magicka, Stamina
					Health ; Change Health
					Magicka ; Change Magicka
					Stamina ; Change Stamina
				drainC ; Is this a stat drain?
					TRUE ; Values will decrease stats
					FALSE ; Values will increase stats
				aMOD ; Calculates an added percentage gain or loss
				aEffect ; Overrides absorption/stat effects (set to 0 to use default)
				dReport ; Sends Notification for the player based on gain
					TRUE ; Send Report
					False ; Don't Send Report
			f. ANIMcalc ; Used to start animations through Succubus Heart (Applies gender locks)
				(string aPreset, actor[] sentActor, actor victimActor=none)
				aPreset ; Sets different modes for sorting
					0 ; Disabled
					Combat ; Used for Combat Seduction (inactive)
					Seduction ; Used for Seduction Spells (inactive)
				sentActor ; Array of actors in the act
				victimActor ; Actor that is considered victim (optional)
	SuH_SuQuest ; Handles Character Specific Succubus Effects not tied to spells
+ Common Scripts +
	Dynamic Scripts
		SuH_dyna_active ; Applies dynamic effects to NPCS (This manages all important script)
		SuH_dyna_applying ; Applues SuH_dyna_active to NPCS
		SuH_dyna_effect ; Used as dynamic cloaking to cover the surrounding area
		SuH_dyna_player ; Applies dynamic effects to the player (This manages all important script)
	SuH_comES_sperm ; Used to apply sperm effects
	SuH_comES_milk ; Used to apply milk effects
+ Global Variables +
	SuH_MODupdate ; MOD version
	SuH_PCSabsorbhealth ; Health Absorption Level (Player)
	SuH_PCSabsorbmagicka ; Magicka Absorption Level (Player)
	SuH_PCSabsorbstamina ; Stamina Absorption Level (Player)
	SuH_PCSspermhealth ; Sperm Health Gain Level (Player)
	SuH_PCSspermmagicka ; Sperm Magicka Gain Level (Player)
	SuH_PCSspermstamina ; Sperm Stamina Gain Level (Player)
	SuH_PCSmilkhealth ; Milk Health Gain Level (Player)
	SuH_PCSmilkmagicka ; Milk Magicka Gain Level (Player)
	SuH_PCSmilkstamina ; Milk Stamina Gain Level (Player)
	SuH_PCScaphealth ; Health Cap (Player)
	SuH_PCScapmagicka ; Magicka Cap (Player)
	SuH_PCScapstamina ; Stamina Cap (Player)
	SuH_PCSforce ; Force Collected which converts to SP
	SuH_PCSxp ; Heart XP
	SuH_PCSsp ; Heart SP
	SuH_PCSxpgain ; XP gain multiplier
	SuH_PCSxpearn ; Base XP earn value
	SuH_PCSspearned ; Total SP earned (Spent and un-Spent)
	SuH_SETallowdrainkill ; Setting, allow stat drain to kill targets
		1 = TRUE ; Kill targets if their Health drops below 1
		0 = FALSE ; Targets won't die from drain
	SuH_PCSdesire ; Gained over time and unlocks seduction spells (consumed during acts)
	SuH_PCSstacksex ; Sex Stacks increased with sex acts
	SuH_PCSstacksperm ; Sperm stacks increased by consuming sperm
	SuH_PCSstackmilk ; Sperm stacks increased by consuming milk
	SuH_PCSstackmaxsex ; Max Sex Stack obtainable
	SuH_PCSstackmaxsperm ; Max Sperm Stacks obtainable
	SuH_PCSstackmaxmilk ; Max Milk Stacks obtainable
	SuH_SETallowmalehomo ; Allows male homosexuals within Succubus Heart
		1 = TRUE ; Homosexual animations can be triggered by Succubus Heart
		0 = FALSE ; Homosexual animations won't be triggered by Succubus Heart
	SuH_SETallowfemalehomo ; Allows female homosexuals within Succubus Heart
		1 = TRUE ; Homosexual animations can be triggered by Succubus Heart
		0 = FALSE ; Homosexual animations won't be triggered by Succubus Heart
	SuH_SETcombatseduction ; Allows Combat Seduction (combat triggered animations)
		1 = TRUE ; Hits will trigger combat seduction checks
		0 = FALSE ; Hits won't trigger combat seduction checks
	SuH_SETnpc2npchealth ;Determines Health value where combat seduction triggers below
	SuH_SETnpc2pchealth ;Determines Health value where combat seduction triggers below
	SuH_SETpc2npchealth ;Determines Health value where combat seduction triggers below
+ Added Faction +
	SuH_Tracker ; Used in MODevents and dyna spells to capture animation events
+ Spells +
	SuH_sex_PCmastery
		SuH_sexE_PCmastery ; Applies PC Mastery effect
			s. SuH_sexES_PCmastery
				f. SuH_Fun.XPcalc
				f. SuH_Fun.STATcalc
	SuH_sex_PCtraining
		SuH_sexE_PCtraining ; Applies PC Traning Effect
			s. SuH_sexES_PCtraining
				f. SuH_Fun.XPcalc
				f. SuH_Fun.STATcalc
	SuH_sex_PCsubmit
		SuH_sexE_PCsubmit ; Applies PC Submit Effect
			s. SuH_sexES_PCsubmit
				f. SuH_Fun.XPcalc
				f. SuH_Fun.STATcalc
	SuH_sex_NPCattacker
		SuH_sexE_NPCattacker
			SuH_sexES_NPCattacker
	SuH_sex_NPCconsent
		SuH_sexE_NPCconsent
			SuH_sexES_NPCconsent
	SuH_sex_NPCvictim
		SuH_sexE_NPCvictim
			SuH_sexES_NPCvictim
+ ingredients +

Gameplay Objects
+ ingredients + ; Items which can appear as sex drops
	Sperm
		SuH_ing_sperm ; General Sperm  (Drops from all males)
			SuH_comE_sperm
				SuH_comES_sperm
	Breast Milk
		SuH_ing_milk ; General Milk (Drops from all females)
			SuH_comE_milk
				SuH_comES_milk
	Vitality Stone ; Increase all Status caps by 2
		SuH_ing_vitalitystone
			SuH_comE_vitalitystone
				SuH_comES_vitalitystone
	unnamed ; [Increase XP gain by 1%]
	unnamed ; [Increase all sex absorption by 1]
	unnamed ; [Increase all sperm absorption by 1]
	unnamed ; [Increase all milk absorption by 1]
	unnamed ; [Decrease SP cost by 5*]
	unnamed ; [Grants 500xp]
+ Passives + ; Abilities which grant passive effects based on their leveled rank
	Sly Partner ; [Steals 1(+rank) Gold]
	Perfect Orgasm ; [Increases the chance of a special drop on orgasms (1+rank)]
	Savory Fluids ; [Sperm and Milk recovers 10(+5*rank) points of missing status]
	Masochist ; [Grants 5xp(+5*rank) when hit]
	Self Stacker ; [Grants 1(+rank) stack based on gender (m/sperm f/milk)]
	Value Stacker ; [Increases number of stacks earned by 1(+rank)]
	Saving Essence ; [When hit below 30% Health consume up to 10 sperm stacks, recovering 2(+2*rank) Health per stack]
	Milk Drinker ; [Consume up to 5 milk stacks when hitting a target, adding 2(+2*rank) damage per-stack]
	
+ Spells + ; Spells the player can use for special effects
	Sexual Enrage ; Sexual Enrage [Base] "Forces the target to rape the caster"
		SuH_spell_sexualenrage
			SuH_spellE_sexualenrage
				SuH_spellES_sexualenrage
	Sexual Entice ; [Consent Spell]
	
	Focus Shot ; (Quick Damage Spell)
		[Base] ; 500 XP ("Consume 5 Max Stamina and deal 5 damage to the target")
		SuH_spell_focusshot_base
			SuH_spellE_focusshot_base
				SuH_spellES_focusshot_base
		[Love] ; ["Consume 12 Max Stamina and deal 14 damage to the target"]
		
		[Hate] ; 5000 XP ("Consume 12 Max Stamina and deal 6 damage to the target while absorbing 3 health")
		SuH_spell_focusshot_drain
			SuH_spellE_focusshot_drain
				SuH_spellES_focusshot_drain
				
	Unnamed ; (High Damage Spell)
		[Base] ; [Consume 10 Health and 20 Magicka to damage the target for 50 Health]
		
		[Love] ; [Consume 15 Health and 35 Magicka and damage the target for 80 Health and reduce their Max Health by 10%]
		
		[Hate] ; [Consume 50% Max Health while reducing the target's Max Health by 60%]
		
	Intimate Touch ; (Silent Touch Spell)
		[Base] ; [Touch the target without aggression consuming up to 15 sex stacks, damaging them for 5% status per stack.]
		
		[Love] ; [Touch the target without aggression consuming up to 9 sex stacks, damaging them for 10% status per stack.]
		
		[Hate] ; [Touch the target without aggression consuming up to 10 sex stacks, draining them of 5% status per-stack]
		
	Vital Drain ; (Drain Spell)
		[Base]
		
		[Love]
		
		[Hate]
		
	Cursed Blood ; (Curse Spell)
		[Base] ; [Consume 10 Magicka and 5 Stamina and paralyze the target for 2 seconds]
		
		[Love] ; [Consume 15 Magicka and 15 Stamina and paralyze the target for 5 seconds]
		
		[Hate] ; [Consume 5 sex stacks and curse the target to die after their next sex act (lasts 10 minutes)]
		
	Unnamed ; (Recovery Spell)
		[Base] ; [Consume 15 Magicka and restore 50% missing Health]
		
		[Love] ; [Consume 25 Magicka and restore 80% Health]
		
		[Hate] ; [Consume 30 Health and 20 Magicka to remove diseases]
		

; [][][] Fill